百度地图服务生态

加油基础推送 | 商户->百度

更新时间：2024-03-04

1. 油站、油价数据推送（必须）

1.1推送频率

1）实时变更数据推送，包括油站状态、油价等

2）每天一次全量数据推送（含油站状态、油价）

1.2推送地址

测试地址：https://maphotel.baidu.com/map_mc/mc/tpnotify?topic=e569f262b2a345588af22b13b5892565__test_tp_notify&arg_data_type=gas_station

线上地址：平台分配

推送方式：HTTP POST，将推送字段打包成JSON格式，写入到HTTP地址。

推送成功返回：

{
    "errno": 0,
    "errstr": "",
    "desc": "",
    "data": {
    }
}

1.3字段

basic对象(油站基础信息):

字段标签 字段名称 字段说明 字段要求 字段长度 是否必须
1 id 油站id 油站唯一标识 string 64 是
2 poi_name 油站名称 准确的油站名称,例如:壳牌加油站、xx加油站等 string 256 是
3 city 所在地城市 北京、上海(传入城市名称) string 64 是
poi_address 油站地址 详细的地址,例如:辽宁省,沈阳市,皇姑区,黄河北大街xxx号 string 256 是
latitude 油站所在地纬度 百度坐标(BD09MC) double 64 是
longitude 油站所在地经度 百度坐标(BD09MC) double 64 是
tel 门店联系方式 联系电话或手机号码等 string 64 是
status 营业状态 参考附录:油站基础数据状态(status)取值说明 int - 是
county POI所在行政区 东城区(传入行政区名称) string 64 否
aoi POI所在商圈 天安门;王府井地区（可选，多个;分开） string 256 否
brand POI品牌 品牌 string 64 否
shop_business 营业时间 "00:00:00-24:00:00" string - 是
images 油站图片 对象如下 Array - 是
location_type 坐标类型 坐标类型 1-百度，2-腾讯，3-火星 int 64 是

basic.image对象

字段标签 字段名称 字段说明 类型 是否必须
1 image_url 图片链接 string 是
2 image_title 图片名称 string 是
3 image_type 图片类型(exterior外景 、inner内景、firstphoto头图、other其它） string 是

detail对象

字段标签 字段名称 字段说明 字段要求 类型 字段长度 是否必须
1 gas_type 油站类型 gas_brand_name 油站品牌 string 64 否
2 is_invoice 开票信息 是否能开发票 0 不能开 1 能开 2 不确定能不能开 int 4 否
3 is_free 当前排队情况 油站当前是否空闲 0排队 1空闲 int 4 否
4 label_map 标签集合 对象如下 object 否

label_map 对象

参数 类型 含义
1 service_taglist Array 服务类标签列表，具体参考下面 tag 对象
2 activity_taglist Array 活动类标签列表，具体参考下面 tag 对象
3 custom_taglist Array 自定义类标签列表，具体参考下面 tag 对象
4 system_taglist Array 系统促销类标签列表，具体参考下面 tag 对象

tag 对象

参数 类型 含义
1 tag_name String 标签名称
2 tag_image_name String 标签图片 URL
3 tag_index_description String 首页标签描述
4 tag_description String 标签描述
5 tag_type String 标签类型，0:自定义类，1:活动促销类，2:系统促 销类，3:服务类

price_official_list数组(国标价数据)

字段标签 字段名称 字段说明 字段要求 字段长度 是否必须
1 oil_name 油号 92#、98#、0# string 64 是
2 price_official 国标价 单位元 double - 是
3 vs 国标价格相比昨天的变化 0无变化、1今天高、3今天低 int - 否

price_discount_list对象(服务方优惠信息)

字段标签 字段名称 字段说明 字段要求 字段长度 是否必须
1 tp_name 渠道号 开发前分配渠道号和私钥（primary_key），请妥善保管 string 64 是
2 gas_id 油站id 油站唯一标识 string 64 是
3 price_list 价格数组 服务方优惠价格信息 array - 是
4 oil_name 油号 92#、98#、0# string 64 是
5 org_price 油站挂牌价 double - 是
6 price 通用优惠价 double - 是
7 vip_price 新客价、VIP客户价 double - 否
8 src平台分配 等同于tp_name值 string 64 是
9 gas_id 油站id 油站唯一标识 string 64 是
10 sku_id 油号标识 1、如果下单页是百度小程序，此字段用于跳转到小程序指定油枪号，由三方提供【这种模式在逐步废弃】 2、下单页 h5，默认传油号：92\85\98\0 string 64 是
11 gunNos 油枪号list ["1","3"] Array - 是
12 original_gas_id 服务商油站id 适用于综和油站来源 sring - 否
13 original_gas_name 服务商英文标识 适用于综和油站来源 string - 否 
{
    "basic": {
        "status": "1",
        "city": "成都市",
        "tel": "4008396555",
        "longitude": 104.182521,
        "poi_address": "青白江区货运大道白马村2组(省市区县精确到门牌号越详细越好)",
        "latitude": 30.872307,
        "id": "92699595369",
        "poi_name": "中国石化白马北加油站",
        "county":"",
        "aoi":"",
        "brand":"中国石化",
        "shop_business":"00:00:00-24:00:00",
        "images":[
             {
                "image_url":"xxxx",
                "image_title":"头图",
                "image_type":"firstphoto"
            },
            {
                "image_url":"xxxx",
                "image_title":"外景",
                "image_type":"exterior"
            }
        ]
    },
    "detail": {
        "gas_type": "中国石化", //油站品牌
        "is_invoice": 2, //是否可开发票
        "is_free":1, //是否空闲
        "label_map": {
            "service_taglist": [
                {
                    "tag_name": "xx",
                    "tag_image_name": "xxx",
                    "tag_index_description": "xxx",
                    "tag_description": "xxx",
                    "tag_type": 1
                }
            ],
            "activity_taglist": [
                {
                    "tag_name": "周二优惠", //标签名称
                    "tag_image_name": "xxx", //标签图片 URL
                    "tag_index_description": "周二优惠", //首页标签描述
                    "tag_description": "周二加汽油可享优惠直降0.8元/L", //标签描述
                    "tag_type": 1 //标签类型
                }
            ],
            "custom_taglist": [
                {
                    "tag_name": "xx",
                    "tag_image_name": "xxx",
                    "tag_index_description": "xxx",
                    "tag_description": "xxx",
                    "tag_type": 1
                }
            ],
            "system_taglist": [
                {
                    "tag_name": "xx",
                    "tag_image_name": "xxx",
                    "tag_index_description": "xxx",
                    "tag_description": "xxx",
                    "tag_type": 1
                }
            ]
        }
    },


    "price_official_list": [ //国标价数据
        {
            "oil_name": "92#", //油号
            "price_official": "6.9", //国标价，单位元
            "vs": "1" //相比昨天的变化,  #0 平 1 今高 3 今低
        },
        {
            "oil_name": "95#",
            "price_official": "7.37",
            "vs": "1"
        },
        {
            "oil_name": "0#",
            "price_official": "6.52",
            "vs": "1"
        }
    ],
    "price_discount_list": {
        "tp_name": "平台分配", //例如 yijiayou
        "gas_id": "5389825986895835545",//油站标识
        "price_list": [
            {
                "oil_name": "92#", //油号
                "org_price": 6.76, //油站挂牌价
                "price": 5.99,  //通用优惠价
                "vip_price": 5.52, //新客价、VIP客户价
                "src": "平台分配", //例如 yijiayou = tp_name
                "gas_id": "5389825986895835545", //油站标识
                "sku_id": "4879454965524071453",//油号标识，百度跳转至三方会在参数中拼接该字段，用于跳转到小程序指定油枪号
                "gunNos" : [    //油枪号
							"1",
							"3",
							"8",
							"10",
							"12",
							"13",
							"14"
						]
            },
            {
                "oil_name": "95#",
                "org_price": 7.22,
                "price": 6.37,
                "vip_price": 5.87,
                "src": "平台分配",
                "gas_id": "5389825986895835545",
                "sku_id": "4879454965540848671",
                "gunNos" : [   //油枪号
							"5",
							"7",
							"9",
							"11"
						],
            }
        ]
    }
}

2. 用户权益推送（可选）

1.1推送频率

1）实时变更数据推送，包括油站状态、油价等

2）天级全量数据推送（含油站状态、油价）

1.2推送地址

测试地址：https://maphotel.baidu.com/map_mc/mc/userright?partner_name=test_tp

线上地址：平台分配

推送方式：HTTP POST，将推送字段打包成JSON格式，写入到HTTP地址。

推送成功返回：

{
    "errno": 0,
    "errstr": "",
    "desc": "",
    "data": {

    }
}

1.3字段

{
    "mobile": "手机号",
    "bdmap_user_id": "由平台跳转到三方时携带",
    "is_new_user": "1" //其他权益字段
}

附1：基础信息status字段说明：通常情况，1为合作站点，2为不合作站点，当status置为2，地图会下线该点位的相关服务。

合作方填写 映射状态
营业中 1
正常营业 1
删除 2
暂停营业 3
筹建中 5
已停业 9
已关闭 9
支付中心填单页| 百度->商户